home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / pascal / fulldb13.zip / FULLDB.DOC < prev    next >
Text File  |  1991-10-15  |  5KB  |  132 lines

  1. FULLDB version 1.3 - Add .OBJ line number information to Turbo Pascal .TPU.
  2.                      Works with TP 5.5, TP 6.0, or TPW 1.0!
  3.  
  4.   Copyright (c) D.J. Murdoch, 1991
  5.  
  6. Syntax: FULLDB tpuname[.TPU] [/Oobjpath]
  7.  
  8.   reads the given .TPU file, and attempts to add line number information
  9.   from all externally linked .OBJ files.
  10.  
  11. Option:
  12.   /Oobjpath:  Search objpath for .OBJ files if they're not in the current
  13.               directory.
  14.  
  15.   This option may be kept in the TPC.CFG file, if that file is on the
  16.   PATH.  A command line option will override the TPC.CFG value.
  17.  
  18. Description:
  19.  
  20.   Turbo Pascal versions 4.0 and up allow you to link external .OBJ files
  21.   written in other languages.  Usually these are written in assembler,
  22.   since the requirements of the TP linker are very strict.
  23.   Unfortunately, all debugging information is lost, which makes it very
  24.   hard to get the assembler code right.
  25.  
  26.   FULLDB fixes this for TP 5.5 and 6.0, and TPW 1.0. If you can get your
  27.   external assembler/compiler to include standard line number
  28.   information in the .OBJ files, FULLDB will copy this into your .TPU
  29.   file.  This will enable you to single step through your external code
  30.   while in the TURBO IDE or in Turbo Debugger.
  31.  
  32. Example:
  33.  
  34.   The following demonstration files are included in this package.  I've
  35.   already done the first few steps in TP 6.0; skip right to compiling
  36.   DEMO.PAS if you're using that version.
  37.  
  38.   Assemble PARSE.ASM with included debug information:
  39.  
  40.     TASM /Zd PARSE
  41.  
  42.   Compile PARSE.PAS, which links in PARSE.OBJ:
  43.  
  44.     TPC /$D+ PARSE.PAS
  45.  
  46.   (Or use the TURBO.EXE IDE to compile it.  It's doesn't matter if you
  47.   include debug information for the Pascal part of the unit.)
  48.  
  49.   Add the PARSE.OBJ line number information to .TPU:
  50.  
  51.     FULLDB PARSE.TPU
  52.  
  53.   Now compile the DEMO program:
  54.  
  55.     TPC /V /$D+ DEMO
  56.      or
  57.     TURBO DEMO
  58.     <F9>
  59.  
  60.   and you'll be able to single step <F7> right into PARSE.ASM, in either
  61.   Turbo Debugger or the IDE.
  62.  
  63. Limitations:
  64.  
  65.   The record in the .TPU file giving the name of the .OBJ file doesn't
  66.   include date & time information.  If the file it finds isn't the same
  67.   one you linked into your .TPU, you're likely to get garbage line
  68.   numbers.  FULLDB will have no way to check on this.
  69.  
  70.   FULLDB can't read full debug information from the .OBJ file.  Only
  71.   line numbers are used, so local symbols won't be available to the
  72.   debugger.  Note that the TP 6.0 IDE has a Registers window available
  73.   using the <AltW>R command.
  74.  
  75.   The lack of local symbols is something I'm working on; if you register
  76.   this copy (see below), you may get the full debug version in the mail.
  77.   This effort would be greatly sped up if someone could point me to
  78.   documentation of the debug info formats in .OBJ files; I already know
  79.   how to add it to the .TPU file once I can read it.
  80.  
  81.  
  82. History:
  83.  
  84.   1.3 - Added search of TPC.CFG, and demonstration code
  85.  
  86.   1.2 - Added /O option
  87.  
  88.   1.1 - Fixed bug with large .ASM files
  89.  
  90.   1.0 - First version
  91.  
  92. License:
  93.  
  94.   FULLDB is not public domain.  It contains code whose copyright belongs
  95.   to D.J. Murdoch, as well as library code from Borland International
  96.   and TurboPower Software.
  97.  
  98.   You are free to use FULLDB without charge for one month.  If you keep
  99.   it beyond that time, you must register it by sending $20 (Canadian or
  100.   U.S. dollars) to me at the address below.  Mention your version
  101.   number; one update will be sent to you when available.  I'll also put
  102.   a collection of other freeware and shareware programming utilities on
  103.   the same disk.  (If you like, you can forgo the free update and
  104.   request the disk of other utilities immediately.)
  105.  
  106.   You may distribute FULLDB unmodified, together with this documentation
  107.   file, provided that you charge no more than distribution costs, and on
  108.   no account more than $10 per copy.
  109.  
  110. Source code:
  111.  
  112.   Source code to FULLDB is available to registered users at a cost of
  113.   $20 (Canadian or U.S. dollars).  Send your payment to me at the
  114.   address below.  You can register it and obtain source code at the same
  115.   time for $35 (Canadian or U.S.).
  116.  
  117. Warranty:
  118.  
  119.   There is no warranty of any kind with this program.  But it's
  120.   shareware - if it doesn't do what you want, throw it away. I can't
  121.   accept responsibility for any damage that bugs in it may cause.  If
  122.   you find any, please send reports to me (Duncan Murdoch) at one of the
  123.   following addresses:
  124.  
  125.   DJ Murdoch at Fidonet node 1:221/177.40
  126.   dmurdoch@watstat.waterloo.edu  on Internet
  127.   71631,122 on Compuserve
  128.  
  129.   79 John St. W
  130.   Waterloo, Ontario, Canada
  131.   N2L 1B7
  132.